Skip to main content

H5混合模块

APP 内嵌 H5 页面如果也需要进行数据采集，H5 页面需要集成 Web JS SDK

若需要 H5 页面 Web JS SDK 采集的数据与 APP 中 GIO SDK 采集的用户等数据打通，请参考 Hybrid内嵌页打通插件

如果 APP 集成的是无埋点 SDK， 不需要做设置，SDK 初始化后会自动注入桥接代码，实现数据打通；

如果 APP 集成的是埋点 SDK，则需要您添加 Hybrid 依赖

info

使用时注意模块版本需要与采集 SDK 版本保持一致

模块集成​

  1. 添加 GrowingModule_Hybrid Package
  1. 一般情况下，Hybrid 将自动注入进行数据采集，如需额外配置，可在目标文件中，导入 import GrowingModule_Hybrid，并调用下列配置接口

模块配置​

Hybrid 模块中提供了配置接口：

1.自动对所有 webView 注入 Hybrid SDK​

配置接口参数类型默认值说明
autoBridgeEnabledBooltrue是否对所有 webView 自动注入 Hybrid SDK
示例​
let hybrid = Hybrid.sharedInstance()
hybrid.autoBridgeEnabled = false

2.单个 webView 启用 Hybrid 注入 (白名单模式)​

enableBridge(_ webView: WKWebView)
在 autoBridgeEnabled 为 false 时，对单个 webView 启用 Hybrid 注入，请在主线程调用

参数参数类型说明
webViewWKWebView当前 webView 实例
示例​
let hybrid = Hybrid.sharedInstance()
hybrid.enableBridge(webView)

3.单个 webView 关闭 Hybrid 注入 (黑名单模式)​

disableBridge(_ webView: WKWebView)
在 autoBridgeEnabled 为 true 时，对单个 webView 关闭 Hybrid 注入，请在主线程调用

参数参数类型说明
webViewWKWebView当前 webView 实例
示例​
let hybrid = Hybrid.sharedInstance()
hybrid.disableBridge(webView)

4.查看 webView 是否可注入​

isBridgeEnabled(_ webView: WKWebView)
判断当前配置下，webView 是否可注入

参数参数类型说明
webViewWKWebView当前 webView 实例
示例​
let hybrid = Hybrid.sharedInstance()
let isBridgeEnabled = hybrid.isBridgeEnabled(webView)

5.重置 Hybrid 注入​

resetBridgeSettings()
重置 Hybrid 注入配置，请在主线程调用

示例​
let hybrid = Hybrid.sharedInstance()
hybrid.resetBridgeSettings()
tip

1. H5 页面 Web JS SDK 采集的数据与 APP 中 GIO SDK 采集的用户等数据打通规则：

  • 两者 accountId 一致时，H5 与 APP 打通，此时 H5 页面上采集的数据仅由 APP 中 GIO SDK 发送
  • 两者 accountId 不一致时，H5 页面上采集的数据同时由 Web JS SDK 和 APP 中 GIO SDK 发送
  • 满足打通设置时，H5 页面调用 setUserID，cleanUserID 会调用 APP 的 setLoginUserID，cleanUserID。

2. 打通成功效果 当触发了打通规则，实现打通设置后，H5 内嵌页采集的数据经 APP 中 GIO SDK 发送数据。以下字段变化如下：
deviceId: 使用原生 App 的d eviceId
sessionId: 使用原生 App 的 sessionId
gioId: 使用原生 App 的 gioId
userId: 使用原生 App 的 userId
userKey: 使用原生 App 的 userKey
dataSourceId: 使用原生 App 的 dataSourceId
platform: 使用原生 App 的 platform
domain: 使用 H5 页面的域名

用户行为与采集数据描述：用户点击 APP 内嵌 H5 页面，由 APP 原生页面进入 H5 页面，H5 页面集成的采集 SDK 会把采集的数据转发给 APP 集成的 SDK，再进行上报；H5 页面的行为数据中的以上用户信息字段会用 APP SDK 采集的用户信息，实现 H5 页面用户与 APP 用户信息关联。